home *** CD-ROM | disk | FTP | other *** search
/ By Popular Request 2.0 / By Popular Request 2.0 (Arsenal Computer).ISO / amiga_5 / pin391bs.lha / pine3.91 / doc / pine.man < prev   
Text File  |  1995-04-09  |  13KB  |  331 lines
  1.  
  2.  
  3.  
  4. pine(1)                                                   pine(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        pine - a Program for Internet News and Email
  9.  
  10. SSYYNNTTAAXX
  11.        ppiinnee [ _o_p_t_i_o_n_s ] [ _a_d_d_r_e_s_s , _a_d_d_r_e_s_s ]
  12.  
  13.        ppiinneeff [ _o_p_t_i_o_n_s ] [ _a_d_d_r_e_s_s , _a_d_d_r_e_s_s ]
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.        Pine  is  a screen-oriented message-handling tool.  In its
  17.        default configuration, Pine offers an  intentionally  lim-
  18.        ited  set  of functions geared toward the novice user, but
  19.        it also has a growing list of  optional  "power-user"  and
  20.        personal-preference  features.  _p_i_n_e_f is a variant of Pine
  21.        that uses function keys rather than mnemonic single-letter
  22.        commands.  Pine's basic feature set includes:
  23.  
  24.               View,  Save,  Export, Delete, Print, Reply and For-
  25.               ward messages.
  26.  
  27.               Compose messages in a  simple  editor  (Pico)  with
  28.               word-wrap  and a spelling checker.  Messages may be
  29.               postponed for later completion.
  30.  
  31.               Full-screen selection  and  management  of  message
  32.               folders.
  33.  
  34.               Address  book to keep a list of long or frequently-
  35.               used addresses.  Personal distribution lists may be
  36.               defined.   Addresses  may be taken into the address
  37.               book from incoming mail without retyping them.
  38.  
  39.               New mail checking and notification occurs automati-
  40.               cally every 2.5 minutes and after certain commands,
  41.               e.g. refresh-screen (Ctrl-L).
  42.  
  43.               On-line, context-sensitive help screens.
  44.  
  45.        Pine supports  MIME  (Multipurpose  Internet  Mail  Exten-
  46.        sions),  an  Internet  Standard for representing multipart
  47.        and multimedia data in email.  Pine  allows  you  to  save
  48.        MIME  objects to files, and in some cases, can also initi-
  49.        ate the correct program for viewing the object.   It  uses
  50.        the  system's _m_a_i_l_c_a_p configuration file to determine what
  51.        program can process a particular MIME object type.  Pine's
  52.        message  composer  does not have integral multimedia capa-
  53.        bility, but any type of data file --including multimedia--
  54.        can  be  attached  to a text message and sent using MIME's
  55.        encoding rules.  This allows any group of individuals with
  56.        MIME-capable  mail  software  (e.g. Pine, PC-Pine, or many
  57.        other programs) to exchange formatted  documents,  spread-
  58.        sheets, image files, etc, via Internet email.
  59.  
  60.        Pine  uses  the _c_-_c_l_i_e_n_t messaging API to access local and
  61.  
  62.  
  63.  
  64.                            Version 3.90                         1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. pine(1)                                                   pine(1)
  71.  
  72.  
  73.        remote mail folders. This library provides  a  variety  of
  74.        low-level  message-handling  functions,  including drivers
  75.        for a variety of different mail file formats, as  well  as
  76.        routines  to  access  remote  mail and news servers, using
  77.        IMAP (Internet Message Access Protocol) and NNTP  (Network
  78.        News   Transport  Protocol).   Outgoing  mail  is  usually
  79.        handed-off to  the  Unix  _s_e_n_d_m_a_i_l,  program  but  it  can
  80.        optionally be posted directly via SMTP (Simple Mail Trans-
  81.        fer Protocol).
  82.  
  83. OOPPTTIIOONNSS
  84.        The command line options/arguments are:
  85.  
  86.        _a_d_d_r_e_s_s             Send mail to _a_d_d_r_e_s_s_.  This will cause
  87.                            Pine  to  go directly into the message
  88.                            composer.
  89.  
  90.        --aa                  Special anonymous mode for UWIN*
  91.  
  92.        --dd _d_e_b_u_g_-_l_e_v_e_l      Output diagnostic info at  _d_e_b_u_g_-_l_e_v_e_l
  93.                            (0-9)  to the current _._p_i_n_e_-_d_e_b_u_g_[_1_-_4_]
  94.                            file.  A value of  0  turns  debugging
  95.                            off  and  suppresses  the  _._p_i_n_e_-_d_e_b_u_g
  96.                            file.
  97.  
  98.        --ff _f_o_l_d_e_r           Open  _f_o_l_d_e_r  (in  default  mail  dir)
  99.                            instead of INBOX.
  100.  
  101.        --FF _f_i_l_e             Open  named  text  file  and view with
  102.                            Pine's browser.
  103.  
  104.        --hh                  Help: list valid command-line options.
  105.  
  106.        --ii                  Start up in the FOLDER INDEX screen.
  107.  
  108.        --II _k_e_y_s_t_r_o_k_e_s       Initial   (comma  separated  list  of)
  109.                            keystrokes which Pine  should  execute
  110.                            on startup.
  111.  
  112.        --kk                  Use  function  keys for commands. This
  113.                            is the same  as  running  the  command
  114.                            _p_i_n_e_f.
  115.  
  116.        --ll                  Expand  all collections in FOLDER LIST
  117.                            display.
  118.  
  119.        --nn _n_u_m_b_e_r           Start up with  current  message-number
  120.                            set to _n_u_m_b_e_r_.
  121.  
  122.        --nnrr                 Special mode for UWIN*
  123.  
  124.        --oo                  Open first folder read-only.
  125.  
  126.        --pp _c_o_n_f_i_g_-_f_i_l_e      Use   _c_o_n_f_i_g_-_f_i_l_e   as   the  personal
  127.  
  128.  
  129.  
  130.                            Version 3.90                         2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. pine(1)                                                   pine(1)
  137.  
  138.  
  139.                            configuration  file  instead  of   the
  140.                            default _._p_i_n_e_r_c.
  141.  
  142.        --PP _c_o_n_f_i_g_-_f_i_l_e      Use  _c_o_n_f_i_g_-_f_i_l_e  as the configuration
  143.                            file instead  of  default  system-wide
  144.                            configuration file _p_i_n_e_._c_o_n_f.
  145.  
  146.        --rr                  Use  restricted/demo  mode.  _P_i_n_e will
  147.                            only send mail to itself and functions
  148.                            like save and export are restricted.
  149.  
  150.        --zz                  Enable  ^Z  and SIGTSTP so pine may be
  151.                            suspended.
  152.  
  153.        --ccoonnff               Produce a  sample/fresh  copy  of  the
  154.                            system-wide     configuration    file,
  155.                            _p_i_n_e_._c_o_n_f_,  on  the  standard  output.
  156.                            This  is  distinct  from  the per-user
  157.                            _._p_i_n_e_r_c file.
  158.  
  159.        --ccrreeaattee__lluu _a_d_d_r_b_o_o_k _s_o_r_t_-_o_r_d_e_r
  160.                            Creates  auxiliarly  index   (look-up)
  161.                            file  for  _a_d_d_r_b_o_o_k and sorts _a_d_d_r_b_o_o_k
  162.                            in _s_o_r_t_-_o_r_d_e_r_, which may be _d_o_n_t_-_s_o_r_t_,
  163.                            _n_i_c_k_n_a_m_e_,   _f_u_l_l_n_a_m_e_,   _n_i_c_k_n_a_m_e_-_w_i_t_h_-
  164.                            _l_i_s_t_s_-_l_a_s_t_,  _o_r   _f_u_l_l_n_a_m_e_-_w_i_t_h_-_l_i_s_t_s_-
  165.                            _l_a_s_t_.   Useful when creating global or
  166.                            shared address books.
  167.  
  168.        --ppiinneerrcc _f_i_l_e        Output fresh pinerc  configuration  to
  169.                            _f_i_l_e_.
  170.  
  171.        --ssoorrtt _o_r_d_e_r         Sort  the  FOLDER INDEX display in one
  172.                            of the following orders: _a_r_r_i_v_a_l_, _s_u_b_-
  173.                            _j_e_c_t_, _f_r_o_m_, _d_a_t_e_, _s_i_z_e_, _o_r_d_e_r_e_d_s_u_b_j or
  174.                            _r_e_v_e_r_s_e_. _A_r_r_i_v_a_l order is the default.
  175.                            The  OrderedSubj  choice  simulates  a
  176.                            threaded  sort.   Any  sort   may   be
  177.                            reversed  by  adding  _/_r_e_v_e_r_s_e  to it.
  178.                            _R_e_v_e_r_s_e  by  itself  is  the  same  as
  179.                            _a_r_r_i_v_a_l_/_r_e_v_e_r_s_e.
  180.  
  181.        _-_o_p_t_i_o_n_=_v_a_l_u_e       Assign  _v_a_l_u_e  to  the  config  option
  182.                            _o_p_t_i_o_n  e.g.  -signature-file=sig1  or
  183.                            -feature-list=signature-at-bottom
  184.                            (Note: feature-list values  are  addi-
  185.                            tive)
  186.  
  187.        * UWIN = University of Washington Information Navigator
  188.  
  189. CCOONNFFIIGGUURRAATTIIOONN
  190.        There  are several levels of Pine configuration.  Configu-
  191.        ration values at a  given  level  over-ride  corresponding
  192.        values   at   lower   levels.    In  order  of  increasing
  193.  
  194.  
  195.  
  196.                            Version 3.90                         3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. pine(1)                                                   pine(1)
  203.  
  204.  
  205.        precedence:
  206.  
  207.         o built-in defaults.
  208.         o system-wide _p_i_n_e_._c_o_n_f file.
  209.         o  personal  _._p_i_n_e_r_c  file  (may  be  set  via   built-in
  210.        Setup/Config menu.)
  211.         o command-line options.
  212.         o system-wide _p_i_n_e_._c_o_n_f_._f_i_x_e_d file.
  213.  
  214.        There is one exception to the rule that configuration val-
  215.        ues are replaced by the value of  the  same  option  in  a
  216.        higher-precedence file: the feature-list variable has val-
  217.        ues that are additive, but can be  negated  by  prepending
  218.        "no-"  in  front  of an individual feature name. Unix Pine
  219.        also uses the following environment variables:
  220.  
  221.          TERM
  222.          DISPLAY      (determines  if  Pine  can  display   IMAGE
  223.        attachments.)
  224.          SHELL       (if not set, default is /bin/sh )
  225.          MAILCAPS     (semicolon  delimited list of path names to
  226.        mailcap files)
  227.  
  228. FFIILLEESS
  229.        /usr/spool/mail/xxxx        Default  folder  for  incoming
  230.        mail.
  231.        ~/mail                      Default   directory  for  mail
  232.        folders.
  233.        ~/.addressbook              Default address book file.
  234.        ~/.addressbook.lu           Default  address  book   index
  235.        file.
  236.        ~/.pine-debug[1-4]          Diagnostic  log for debugging.
  237.        ~/.pinerc                   Personal pine config file.
  238.        ~/.newsrc                   News subscription/state  file.
  239.        ~/.signature                Default signature file.
  240.        ~/.mailcap                  Personal   mail   capabilities
  241.        file.
  242.        /etc/mailcap                System-wide mail  capabilities
  243.        file.
  244.        /usr/local/lib/pine.info    Local pointer to system admin-
  245.        istrator.
  246.        /usr/local/lib/pine.conf    System-wide      configuration
  247.        file.
  248.        /usr/local/lib/pine.conf.fixed  Non-overridable configura-
  249.        tion file.
  250.        /tmp/.\usr\spool\mail\xxxx  Per-folder mailbox lock files.
  251.        ~/.pine-interrupted-mail    Message which was interrupted.
  252.        ~/mail/postponed-msgs       For postponed messages.
  253.        ~/mail/sent-mail            Outgoing    message    archive
  254.        (FCC).
  255.        ~/mail/saved--messages      Default destination for Saving
  256.        messages.
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                            Version 3.90                         4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. pine(1)                                                   pine(1)
  269.  
  270.  
  271. SSEEEE AALLSSOO
  272.        pico(1), binmail(1), aliases(5), mailaddr(7), sendmail(8),
  273.        spell(1), imapd(8)
  274.  
  275.        Newsgroup: comp.mail.pine
  276.        Source                                       distribution:
  277.        ftp://ftp.cac.washington.edu/pine/pine.tar.Z
  278.        Pine Technical Notes, included in the source distribution.
  279.        C-Client  messaging  API  library,  included in the source
  280.        distribution.
  281.  
  282. AACCKKNNOOWWLLEEDDGGMMEENNTTSS
  283.        The University of Washington Pine development team (part of the UW Office
  284.        of Computing & Communications) includes:
  285.  
  286.         Project Leader:           Mike Seibel.
  287.         Principal authors:        Mike Seibel, Steve Hubert, Laurence Lundblade.
  288.         C-Client library & IMAPd: Mark Crispin.
  289.         Pico, the PIne COmposer:  Mike Seibel.
  290.         Bug triage, user support: David Miller.
  291.         Port integration:         David Miller.
  292.         Documentation:            Sheryl Erez, Kathryn Sharpe.
  293.         PC-Pine for DOS:          Mike Seibel.
  294.         PC-Pine for Windows:      Tom Unger.
  295.         Project oversight:        Terry Gray.
  296.         Principal Patrons:        Ron Johnson, Mike Bryant.
  297.         Additional support:       NorthWestNet.
  298.         Initial Pine code base:   Elm, by Dave Taylor & USENET Community Trust.
  299.         Initial Pico code base:   MicroEmacs 3.6, by Dave G. Conroy.
  300.         User Interface design:    Inspired by UCLA's "Ben" mailer for MVS.
  301.         Suggestions/fixes/ports:  Folks from all over!
  302.  
  303.        Copyright 1989-1994 by the University of Washington.
  304.        Pine and Pico are trademarks of the University of Washington.
  305.  
  306.        94.08.22
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                            Version 3.90                         5
  329.  
  330.  
  331.